Einheit 2 — Claude Code mit 42°flow verbinden

Was du nach dieser Einheit weißt: Du hast Claude Code mit deinem 42°flow-Konto verbunden, kennst die Konfigurationsfalle, an der die meisten zuerst scheitern, und kannst die Verbindung prüfen.

Was du brauchst

Bestandteil	Woher
Claude Code	Installation über npm install -g @anthropic-ai/claude-code oder die Desktop-App
42°flow-Zugang	Dein normaler Benutzer — die Werkzeuge arbeiten mit deinen Rechten
MCP-Token	Aus 42°flow, siehe unten
Endpunkt-URL	Die MCP-Adresse deiner Instanz, z. B. https://workflow.42-grad.com/mcp

📸 Screenshot: [Platzhalter — 42°flow: Wo der MCP-Token erzeugt wird]

Schritt 1 — Token erzeugen

Der MCP-Token ist ein JWT mit begrenzter Laufzeit (typischerweise rund 90 Tage). Er identifiziert dich gegenüber dem MCP-Server. Alles, was über die Werkzeuge passiert, passiert unter deinem Benutzer.

Laufzeit notieren

Der Token läuft ab. Schreib dir das Ablaufdatum auf. Wenn die Werkzeuge eines Tages ohne erkennbaren Grund nicht mehr antworten, ist das fast immer die erste Ursache — nicht ein Fehler in deinem Quelltext.

Schritt 2 — Server eintragen

Claude Code liest seine MCP-Server aus ~/.claude.json. Der Eintrag sieht so aus:

{
  "mcpServers": {
    "42flow": {
      "type": "http",
      "url": "https://workflow.42-grad.com/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Alternativ über die Kommandozeile:

claude mcp add --transport http 42flow https://workflow.42-grad.com/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

Die häufigste Fehlerquelle

Die Beispielkonfiguration, die 42°flow ausliefert, nennt als Transporttyp "streamable-http". Das ist das Format von Cursor und GitHub Copilot.

Claude Code erwartet "type": "http". Mit "streamable-http" lädt der Server stillschweigend nicht — es erscheint keine Fehlermeldung, die Werkzeuge fehlen einfach.

Wenn nach der Einrichtung keine 42flow-Werkzeuge auftauchen, prüfe zuerst diese eine Zeile.

Schritt 3 — Verbindung prüfen

Starte Claude Code neu und lass dir die Server anzeigen:

/mcp

Der Server 42flow sollte als verbunden gelistet sein, mit 27 Werkzeugen. Der beste Funktionstest ist ein harmloser Lesezugriff — bitte Claude Code einfach:

„Liste meine 42°flow-Projekte auf."

Die Antwort kommt aus project_list und sieht sinngemäß so aus:

{
  "projects": [
    { "id": 9,  "name": "010 | Auftragsverarbeitung", "workflow_count": 13 },
    { "id": 7,  "name": "030 | Artikelanlage",        "workflow_count": 6 },
    { "id": 2,  "name": "Unassigned",                 "workflow_count": 7 }
  ]
}

Wenn hier deine echten Projekte stehen, ist die Verbindung in Ordnung.

📹 Video: [Platzhalter — Screencast: Token erzeugen, Server eintragen, erste Werkzeugabfrage]

Wenn es nicht funktioniert

Symptom	Wahrscheinliche Ursache
Keine 42flow-Werkzeuge sichtbar	"type" steht auf "streamable-http" statt "http"
401 oder unauthorized	Token abgelaufen oder falsch kopiert (Leerzeichen am Ende)
Server verbunden, aber leere Listen	Token gehört zu einem anderen Benutzer als erwartet
Verbindung bricht sporadisch ab	Netz-/Proxy-Thema — die Instanz muss von deinem Rechner erreichbar sein

Der Notausgang: direkt per curl

Falls der Server in einer Sitzung nicht geladen ist, du aber trotzdem an ein Werkzeug musst, kannst du den MCP-Endpunkt direkt ansprechen. MCP über HTTP läuft in zwei Schritten: erst initialize, dann die eigentlichen Aufrufe mit der Session-ID aus dem Antwort-Header.

# 1) Session eröffnen - die Mcp-Session-Id steht im Response-Header
curl -i -X POST https://workflow.42-grad.com/mcp \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2024-11-05","capabilities":{},
       "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2) Werkzeug aufrufen - mit der Session-ID aus Schritt 1
curl -X POST https://workflow.42-grad.com/mcp \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Mcp-Session-Id: DIE_SESSION_ID" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"project_list","arguments":{}}}'

Das brauchst du im Alltag nicht. Aber es ist gut zu wissen, dass hinter den Werkzeugen nichts Magisches steckt — nur HTTP.

Zusammengefasst

1. Token in 42°flow erzeugen und Ablaufdatum notieren
2. Server in ~/.claude.json eintragen — "type": "http", nicht "streamable-http"
3. Claude Code neu starten, mit /mcp prüfen
4. Funktionstest mit einem Lesezugriff wie project_list

Weiter: Einheit 3 — Der Werkzeugkasten im Überblick